- Action die
- 4
- Stat
- 2
- Stat name
- shadow
- Adds
- 0
- Score
- 6
- Challenge die 1
- 1
- Challenge die 2
- 6
- Outcome
- Weak hit
Inline Mechanics
Iron Vault can display game mechanics as compact inline elements that flow naturally with your prose. Instead of full mechanics code blocks, inline mechanics render as styled spans within your paragraphs, creating a more narrative reading experience.
In Iron Vault settings under "Inline mechanics", enable Use inline mechanics to switch from code blocks to inline format. This single toggle affects all mechanics types: moves, oracles, progress tracks, clocks, meters, entities, dice rolls, and OOC comments.
When you perform an action with inline mechanics enabled, Iron Vault inserts a compact code snippet that renders as styled text within your paragraph.
With mechanics blocks (default):
Kira attempts to slip past the guards.
She manages to stay hidden.
Kira attempts to slip past the guards. Face Danger(shadow)—6 vs 1|6 She manages to stay hidden.
The inline code renders as a styled span showing the move name, stat, outcome icon, score, and challenge dice.
The Hide mechanics completely setting (found in Iron Vault plugin settings) hides all mechanics from view (both inline mechanics and code blocks). This is useful when you want to read your journal as pure narrative without any game mechanics visible. The mechanics are still in your notes, they're just hidden from display. You can also toggle this quickly using the "Toggle displaying mechanics" command.
Inline mechanics include clickable elements:
This matches the behavior of links in mechanics code blocks.
Iron Vault supports 19 different inline mechanic types, organized into categories below.
iv-move)Displays action roll results with outcome styling.
Syntax:
`iv-move:<name>|<stat>|<action>|<statVal>|<adds>|<vs1>|<vs2>[|<moveId>][|burn=<orig>:<reset>][|adds=<detail>]`
Parameters:
name - Move name (e.g., "Face Danger")stat - Stat used (e.g., "shadow")action - Action die result (typically 1-6 for a standard d6, but may vary with custom dice settings)statVal - Stat valueadds - Total adds (sum of all bonuses)vs1, vs2 - Challenge dice results (typically 1-10 for d10s, but may vary with custom dice settings)moveId (optional) - Datasworn move ID for linkingburn (optional) - Momentum burn as orig:reset (momentum value used, then reset value)adds (optional) - Detailed adds breakdown as amount(desc),amount(desc) for tooltip displayExamples:
Strike(iron)—7 vs 3|7
Face Danger(shadow)—5 vs 5|9
Clash(iron)—8 vs 3|7
Display: Shows outcome icon, move name (clickable if moveID is provided), stat in parentheses, score, and challenge dice. Left border indicates outcome (green/orange/red). Burn shows a flame icon. Match shows "MATCH" text.
Tooltip: Shows outcome text, full roll breakdown including adds, and burn info if applicable.
iv-progress)Displays progress roll results (Fulfill Your Vow, etc.).
Syntax:
`iv-progress:<moveName>|<trackName>|<score>|<vs1>|<vs2>[|<trackPath>][|<moveId>]`
Parameters:
moveName - The progress move name (e.g., "Fulfill Your Vow")trackName - Name of the progress trackscore - Progress score (filled boxes, 0-10)vs1, vs2 - Challenge dice resultstrackPath (optional) - Path to track file for linkingmoveId (optional) - Datasworn move ID for linkingExamples:
Fulfill Your VowMy Vow—7 vs 3|9
Fulfill Your VowMy Vow—7 vs 3|9
Fulfill Your VowMy Vow—7 vs 3|9
Display: Shows outcome icon, move name (clickable), track name (clickable if path provided), score, and challenge dice.
iv-noroll)Displays moves that don't require dice rolls (Begin a Session, etc.).
Syntax:
`iv-noroll:<name>[|<moveId>]`
Parameters:
name - Move namemoveId (optional) - Datasworn move ID for linkingExamples:
Begin a Session
Begin a Session
Display: Shows a file-pen icon and the move name (clickable if moveId provided).
iv-oracle)Displays oracle roll results.
Syntax:
`iv-oracle:<name>|<roll>|<result>[|<oracleId>][|cursed=<value>]`
Parameters:
name - Oracle nameroll - Die roll result (1-100)result - Oracle result textoracleId (optional) - Datasworn oracle ID for linkingcursed (optional) - Cursed die value (Sundered Isles)Examples:
Action:Bolster
Action:Bolster
Cursed Cargo:Haunted remains7
Display: Shows sparkles icon, oracle name with colon (clickable), and result. Cursed die shows skull icon with value.
Tooltip: Shows roll value and cursed die value if present.
iv-track-create)Records creation of a new progress track.
Syntax:
`iv-track-create:<name>|<path>`
Examples:
Swear to protect the village
Display: Shows square-stack icon and track name (clickable link to file).
iv-track-advance)Records progress marked on a track.
Syntax:
`iv-track-advance:<name>|<path>|<from>|<to>|<rank>|<steps>`
Parameters:
name - Track namepath - Path to track filefrom - Starting ticks (0-40)to - Ending ticks (0-40)rank - Challenge rank (troublesome, dangerous, formidable, extreme, epic)steps - Number of times progress was markedExamples:
My Vow +2 (2/10)
Epic Quest +1 (1/10)
Display: Shows copy-check icon, track name (clickable), steps added, and boxes filled (e.g., "+2 (4/10)").
Tooltip: Shows previous and current box count and rank.
iv-track-complete)Records completion of a progress track.
Syntax:
`iv-track-complete:<name>|<path>`
Examples:
My Vow
Display: Shows square-check-big icon and track name (clickable).
iv-track-reopen)Records reopening a previously completed track.
Syntax:
`iv-track-reopen:<name>|<path>`
Examples:
My Vow
Display: Shows rotate-ccw icon and track name (clickable).
iv-clock-create)Records creation of a new clock.
Syntax:
`iv-clock-create:<name>|<path>`
Examples:
The Storm Arrives
Display: Shows clock icon and clock name (clickable link to file).
iv-clock-advance)Records advancement of a clock, optionally with an odds roll.
Syntax:
`iv-clock-advance:<name>|<path>|<from>|<to>|<segments>|<total>[|odds=<odds>:<roll>:<result>]`
Parameters:
name - Clock namepath - Path to clock filefrom - Starting filled segmentsto - Ending filled segmentssegments - Number of segments addedtotal - Total clock segments (4, 6, 8, or 10)odds (optional) - Odds roll as odds:roll:result (e.g., "Likely:45:Yes")Examples:
Danger +2 (4/6)
Conspiracy +2 (4/6) ✓Likely
Conspiracy (2/6) ✗Unlikely
Display: Shows clock-arrow-up icon, clock name (clickable), segments added, and progress (e.g., "+2 (4/6)"). Successful odds rolls show "✓Likely", failed show "✗Unlikely" with muted styling.
Tooltip: Shows segment change and odds roll details.
iv-clock-resolve)Records resolution of a clock.
Syntax:
`iv-clock-resolve:<name>|<path>`
Examples:
The Storm Arrives
Display: Shows circle-check-big icon and clock name (clickable).
iv-meter)Records changes to character meters (health, spirit, supply, etc.).
Syntax:
`iv-meter:<name>|<from>|<to>`
Examples:
Health 5→3
Spirit 2→4
Momentum 4→3
Display: Shows trending-up or trending-down icon based on direction, meter name, and change (e.g., "Health 5→3"). Left border is green for increases, red for decreases.
iv-burn)Records burning momentum to improve a roll.
Syntax:
`iv-burn:<from>|<to>`
Examples:
Burn 8→2
Burn 10→2
Display: Shows flame icon, "Burn" label, and change. Orange left border.
iv-initiative)Records changes in initiative or position state.
Syntax:
`iv-initiative:<label>|<from>|<to>`
Parameters:
label - Label text (e.g., "Initiative", "Position")from - Previous state (can be empty)to - New stateValid states: "in control", "in a bad spot", "out of combat"
Examples:
Position:In control
Position:In a bad spot
Position:Out of combat
Display: Shows footprints icon, label with colon, and current state. Border color reflects state (green for "in control", red for "in a bad spot").
iv-entity-create)Records creation of an entity file (NPC, planet, faction, etc.).
Syntax:
`iv-entity-create:<entityType>|<name>|<path>`
Examples:
NPC:Kira Vex
Planet:Forge-7
Faction:The Iron Syndicate
Display: Shows file-plus icon, entity type label, and entity name (clickable link to file).
iv-dice)Records an arbitrary dice roll.
Syntax:
`iv-dice:<expression>|<result>`
Examples:
2d6+1 → 8
1d100 → 67
3d6 → 12
Display: Shows dice icon, expression, arrow, and result.
iv-action-roll)Records an action roll without an associated move.
Syntax:
`iv-action-roll:<stat>|<action>|<statVal>|<adds>|<vs1>|<vs2>[|burn=<orig>:<reset>][|adds=<detail>]`
Examples:
(iron)—7 vs 3|7
(shadow)—8 vs 5|9
(heart)—10 vs 4|6
Display: Similar to moves but without a move name. Shows outcome icon, stat in parentheses, score, and challenge dice.
iv-reroll)Records rerolling a die from a previous roll.
Syntax:
`iv-reroll:<die>|<oldVal>|<newVal>|<stat>|<statVal>|<adds>|<vs1>|<vs2>|<action>`
Parameters:
die - Which die was rerolled: "action", "vs1", or "vs2"oldVal - Original die valuenewVal - New die value after rerollstat - Stat namestatVal - Stat valueadds - Total addsvs1, vs2 - Challenge dice (updated if one was rerolled)action - Action die value (updated if it was rerolled)Examples:
(act: 3→6)=9 vs 4|7
(vs1: 8→3)=6 vs 3|5
Display: Shows refresh icon, outcome icon, which die changed (e.g., "(act: 3→6)"), new score, and challenge dice. The rerolled die is highlighted.
iv-ooc)Records out-of-character comments or notes.
Syntax:
`iv-ooc:<text>`
Examples:
Need to look up the rules for this
Taking a break here
Remember to add the bond with Ash later
Display: Shows message-square icon and italic comment text.